home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 February / EnigmA AMIGA RUN 04 (1996)(G.R. Edizioni)(IT)[!][issue 1996-02][Skylink CD III].iso / earcd / comm2 / tafltggr.lha / docs / TAFileTagger.dok < prev    next >
Text File  |  1995-12-03  |  24KB  |  851 lines
  1.  
  2.                                 TransAmiga
  3.                          TAFileTagger-Dokumentation
  4.                                First Release
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30. Einleitung
  31. ----------
  32.  
  33. Hallo TransAmiga-SysOp/SysOma !
  34.  
  35. Ich will zuerst einmal einen kurzen Überblick zum Programm geben.  Und
  36. zwar bietet es dem User / der Userin einen komfortablen Ersatz für das
  37. normale File-Menue mit folgenden Möglichkeiten :
  38.  
  39.  
  40.    * Download,
  41.    * Upload,
  42.    * Private Userarea ohne Änderung der File.cfg,
  43.    * Sysoparea ohne Änderung der File.cfg,
  44.    * FRequest-Handling,
  45.    * Online Sortierung der Files.bbs,
  46.    * Texte ansehen,
  47.    * Archive ansehen, darin Texte lesen,
  48.    * einfacher Wechsel in eine andere Area,
  49.    * User kann Areas "abmelden",
  50.    * Sprachsensitiv,
  51.    * Gruppenstruktur.
  52.  
  53.  
  54. Der  TAFileTagger  ist  soweit  wie  TransAmiga  es  zuläßt   in   die
  55. TransAmigaUmgebung eingebunden. Es werden z.B. alle Filebewegungen des
  56. Users / der Userin auf seinem/ihrem Konto registriert. Die Extras  bei
  57. der  Benutzung  bzw.  der  Installation  werde  ich  bei den einzelnen
  58. Befehlen aufführen.
  59.  
  60.  
  61. Die vorliegende unregistrierte Version hat zur  registrierten  Version
  62. keinerlei funktionelle Einschränkungen.
  63.  
  64.  
  65.  
  66. Befehlsübersicht
  67. ----------------
  68.  
  69.    * Scroll-Befehle
  70.    * Area-Befehle
  71.    * Datei-Befehle
  72.    * Allgemeine Befehle
  73.    * Sysop-Befehle
  74.  
  75.  
  76.  
  77. [Scroll-Befehle]
  78.  
  79.    1, <Ende>   Zum Ende der Liste
  80.    7, <Pos1>   Zum Anfang der Liste
  81.    2, <CrsDwn> Eine Zeile weiter
  82.    8, <CrsUp>  Eine Zeile zurück
  83.    3, <PgDwn>  Eine Seite weiter
  84.    9, <PgUp>   Eine Seite zurück
  85.  
  86.    J +[a..z]   Alphabetischer Sprung
  87.    J +[0...]   Im Gruppen- und Areamenue direkte Anwahl der Area
  88.    .           Alias für J
  89.  
  90.  
  91.  
  92.  
  93. [Area-Befehle]
  94.  
  95.    A, -          Wechsel zum Area-Menue
  96.    G, +          Wechsel zum Gruppen-Menue
  97.    M             Area ex/includen
  98.    P             Wechsel zum privaten FileBereich
  99.    \             Wechsel zum Sysop FileBereich
  100.    <CrsLft>, 4   Vorherige Area
  101.    <CrsRgt>, 6   Nächste Area
  102.    <RETURN>      Anwahl der Gruppe/Area
  103.    Q, 5          Beenden
  104.  
  105.  
  106. [Datei-Befehle]
  107.  
  108.    M   Toggle zum Markieren/Demarkieren der Datei unter dem Cursor
  109.    C   Komplette Markierung aufheben
  110.  
  111.    D   Download der markierten Dateien
  112.    U   Upload
  113.    X   FRequest Datei hochladen
  114.    K   Markierte Dateien archivieren und Downloaden
  115.    N   Neue Beschreibung zum eigenen Upload eingeben
  116.    I   Informationen zur Datei, Long Description lesen
  117.  
  118.    R   Textdatei oder Archivdatei ansehen, innerhalb eines
  119.        Archives besteht die gleiche Benutzeroberfläche wie
  120.        im gesamten Programm.
  121.        Je nach Packertyp können im Archiv auch einzelne
  122.        Textdateien gelesen werden.
  123.  
  124.  
  125. [Allgemeine Befehle]
  126.  
  127.    -              Grundsätzlich ein Menue zurück, bis zum bitteren Ende.
  128.    S              Sortiermenue aufrufen.
  129.    O              Sortieroption anzeigen.
  130.    P              Protokollmenue aufrufen.
  131.    Y              Filestatus des Users.
  132.    ?, H, <Help>   Hilfe.
  133.  
  134.  
  135. [Sysop-Befehle]
  136.   Sie werden im Filemenue mit '\' eingeschaltet. Derzeit sind folgende
  137.   Befehle installiert:
  138.  
  139.    E   Datei unter dem Cursor löschen.
  140.    N   Neue Beschreibung für die aktuelle Datei.
  141.  
  142.  
  143.  
  144.  
  145. Hinweise
  146. --------
  147.  
  148.   Die meisten Kommandos werden in der letzten Zeile angezeigt und alle
  149.   Kommandos  bezüglich des aktuellen Menues sind im Helpscreen genauer
  150.   erklärt. Insbesondere werden grundsätzlich nur Kommandos  angezeigt,
  151.   die auch ausführbar sind!
  152.   Im Header wird das aktuelle Menu bzw. die Area angezeigt.  Innerhalb
  153.   einer  Area  erscheinen  rechts  die Angaben zum Filestatus (Remain,
  154.   Anzahl der markierten Dateien, Anzahl der markierten Bytes).
  155.  
  156.   Markieren  und  Aufheben  der  Markierung  ist  nur  innerhalb   des
  157.   TAFileTaggers  möglich, sollten noch andere Menuepunkte zum Download
  158.   oder Fileliste bestehen, ist kein Querverweis möglich.
  159.  
  160.   Desweiteren startet  TAFileTagger  ohne  Configdatei  oder  falscher
  161.   LanguageDatei in keinsterweise.
  162.  
  163.  
  164. [View File :]
  165.   Die  Handhabung  der   Dateierkennung   ist   wegen   der   gleichen
  166.   Benutzerführung  im  Archiv  selbstprogrammiert.  Es werden folgende
  167.   Packer unterstützt :
  168.  
  169.  
  170.               LHA, LZX, ARJ, ZIP, ZOO, ARC, RAR.
  171.  
  172.  
  173.   Dabei sollten die Packer im  Pfad  stehen,  ich  benutze  nicht  die
  174.   Einträge  aus File.cfg, weil dort meist ein ARexx-Script eingetragen
  175.   ist.
  176.  
  177.   Sollte es Probleme mit dem Archiv-Handling geben, so gebe mir  bitte
  178.   kurz  Bescheid.  Mit  den  Packern,  die  ich  auf  der Platte habe,
  179.   funktioniert es einwandfrei.
  180.  
  181.  
  182. [Upload :]
  183.   Hier ist vor dem Upload ein IndexScan möglich: Der/die  UserIn  wird
  184.   aufgefordert die Dateien zu benennen die er/sie Uploaden möchte. Die
  185.   genannten Dateien werden in der FileBase gesucht  um  festzustellen,
  186.   ob er/sie nicht einen doppelten Upload durchführt.
  187.  
  188.   Ist ein File mit dem gleichen Namen gefunden  worden,  so  erscheint
  189.   ein  Prompt  mit  dem  Eintrag  der Datei aus Files.bbs inklusive in
  190.   welcher Area diese Datei liegt. Es wird eine kurze  Frage  gestellt,
  191.   die aber ansonsten (noch) keine Auswirkung zeigt.
  192.  
  193.   Die Beschreibung durch den/der UserIn kann beliebig lang sein! Diese
  194.   Beschreibung landet abgesehen von Files.bbs der Area zusätzlich noch
  195.   in *.desc der Datei.
  196.  
  197. [SysopArea :]
  198.   Wird bei der Beschreibung als erstes Zeichen ein '/' eingegeben,  so
  199.   wird  die hochgeladene Datei in das Sysopverzeichnis verschoben. Für
  200.   die SysopArea ist defaultmässig  'BBS:SysopFiles'  eingestellt,  ist
  201.   dieses  Verzeichnis  nicht  vorhanden,  so wird es angelegt. Wie bei
  202.   PrivUser-Area muss diese Area nicht im File.cfg erscheinen.
  203.  
  204. [UploadDataFile :]
  205.   Diese Datei wird nach jedem Upload erzeugt und hat folgenden Aufbau:
  206.  
  207.  
  208.          <AreaName>,<UserName>,<FileName>,<Size>,<Date>,<Desc>
  209.  
  210.          <Date> = DD MMM YY
  211.  
  212.  
  213.   Zu finden ist diese Datei im BBS-Systemverzeichnis unter  dem  Namen
  214.   UserUploads.dat?.  Das  Fragezeichen gibt die Anzahl der bestehenden
  215.   UploadDataFiles an.
  216.  
  217. [Download  :]
  218.   Hier ist noch die Möglichkeit eingebaut ein  spezielles  'Protokoll'
  219.   anzugeben,  das  vorher  lange  Dateinamen die auf dem Amiga möglich
  220.   sind, auf 8.3 zu kürzen.
  221.  
  222.  
  223. [Sortierung:]
  224.   Wählt der/die UserIn  diesen  Punkt  an  wird  er/sie  gefragt  nach
  225.   welchen   Kriterien   sortiert   werden   soll.  Möglichkeiten  sind
  226.   Sortierung nach  Filenamen  (Default),  Datum,  Filegröße  und  nach
  227.   Kommentaren  (Absteigend  oder aufsteigend). Die Headerinformationen
  228.   bleiben  von  dieser  Sortierung  unbeeinflußt.  Weitere  Kommentare
  229.   innerhalb der Liste werden der vorherigen Datei zugeordnet.
  230.  
  231.   Ist einmal eine Sortierung angewählt worden, so bleibt diese während
  232.   der  Benutzung  des TAFileTaggers bestehen. Die Sortieroptionen sind
  233.   als  UserName.sort.line  und  als  <UserName>.drift.<line>  im  ENV:
  234.   Verzeichnis zufinden.
  235.  
  236. [Magictextfiles:]
  237.   Es werden die Magictextfiles von TransAmiga beim Upload und Download
  238.   unterstützt. Zusätzlich gibt es folgende Textdateien:
  239.  
  240.   PreCheckIndex   Kurze Erläuterung warum die nächsten Fragen kommen.
  241.   PostUpload      Ein herzliches Danke Schön für den Upload.
  242.   Arg             Sollte der User ein Binary-File lesen wollen, erscheint
  243.                   dieses Textfile.
  244.   PreMarkLimit    Hinweis, daß nicht mehr Dateien markiert werden können.
  245.   PreTimeLimit    Hinweis, daß die OnlineZeit während des Downloads
  246.                   überschritten wird.
  247.   PreRatio        Hinweis, daß sein Upload:Download-Ratio an die Grenze
  248.                   gekommen ist.
  249.  
  250.  
  251. [MagicRexxScripts:]
  252.   Im Grunde werden die  MagicRexxScripts  von  TransAmiga  nach  einem
  253.   Upload  oder  Download  unterstützt.  Die  Besonderheit ist, daß die
  254.   Scripte um die  Zeile  'ADDRESS  'TRANSAMIGA.line''  ergänzt  werden
  255.   müßen.
  256.  
  257. [Help-Screens:]
  258.   Es erscheint ein  Prompt  zum  Download  einer  globalen  Hilfe  zum
  259.   Tagger,   diese  Datei  (Tagger.hlp)  muss  im  Bulletin-Verzeichnis
  260.   liegen!!!
  261.  
  262.    TaggerMainHelp          Die einzelnen Helpfiles zu den Menus.
  263.    TaggerListHelp
  264.    TaggerArcHelp
  265.    TaggerAreaHelp
  266.    TaggerPrivateHelp
  267.    TaggerFreqHelp
  268.  
  269.  
  270.   Sie können entsprechend dem  Userlevel  und  der  Sprache  angepasst
  271.   werden.
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278. Benutzung
  279. ---------
  280.  
  281. Voraussetzungen
  282.  
  283.   Programme      Kickstart 2.0 oder höher. TransAmiga 1.12 oder neueres
  284.                  Release!
  285.   Verzeichnisse  Die Systemverzeichnisse von TransAmiga  ermittelt das
  286.                  Programm selbsttätig, ansonsten werden noch T: und
  287.                  ENV: benutzt.
  288.   Sonstiges      Nerven.
  289.  
  290.  
  291.  
  292.   Der  TAFileTagger  sollte  im  Hauptmenue  installiert  werden.  Bei
  293.   Versionen  älter  als TransAmiga 1.11 (final release) landet der/die
  294.   UserIn in der aktuellen FileArea, obwohl Quit gewählt wurde.
  295.  
  296.   Ab TransAmiga 1.11 läßt sich TAFileTagger auch als kompletter Ersatz
  297.   für  das  Dateimenue fahren, dafür muß das Script TAFileTagger.trans
  298.   in File.trans umbenannt werden.
  299.  
  300.  
  301.  
  302.  
  303.  
  304. Aufruf :
  305.  
  306.      TAFileTagger hat folgende Parameter :
  307.  
  308.  
  309.      LINE           <n>
  310.      CONFIG         <String>
  311.      GROUP
  312.      FIRSTAID
  313.      SPECIALACCESS  <n>
  314.      GUEST          <n>
  315.      PROTOCOL       <n>
  316.      UPLOADDIR      <String>
  317.      CHECK
  318.      UPTIME
  319.      UNAME
  320.      SYSOPDIR       <String>
  321.      UPDATAFILE
  322.      NOTIFY
  323.      TAG            <String>
  324.      ADDR           <n>
  325.      PRIVDIR        <String>
  326.      PRIVACC        <n>
  327.      FREQCFG        <String>
  328.      FREQACC        <n>
  329.      RATIO
  330.      NOREAD
  331.      SETUPDIR       <String>
  332.  
  333.     <n> : Numerischer Wert (s. TAFileTagger.trans oder TAFileTagger.cfg)
  334.  
  335.  
  336.  
  337. Erläuterungen :
  338.  
  339. LINE <n>
  340.   Mit welcher Line soll ich arbeiten, dieser Parameter ist zwingend.
  341.  
  342.  
  343. CONFIG <String>
  344.   Angabe des Configfiles für das Programm. Du kannst  für  zwei  Lines
  345.   ein  und  dasselbe  Configfile benutzen. Folgende Vorgehensweise ist
  346.   implementiert:
  347.  
  348.   1. Einlesen von BBS:Configs/TAFileTagger.cfg
  349.   2. Auswerten der CLI-Parameter
  350.  
  351.      a) Wird ein Config-Parameter gefunden, wird das  angegebene  File
  352.         gelesen.     Vorsicht:    Vorherige    CLI-Parameter    werden
  353.         überschrieben. Umgekehrt werden Parameter aus der Config-Datei
  354.         durch nachfolgende CLI-Parameter überschrieben!
  355.  
  356.  
  357.  
  358.  
  359. FIRSTAID
  360.   Toggle um zu Anfang einen HelpScreen erscheinen zulassen. Vielleicht
  361.   sinnvoll in den ersten Wochen der Installation und bei FirstCallern.
  362.  
  363.  
  364.  
  365. PROTOCOL <n>
  366.   Nummer des FileTransferProtokoll aus der  Konfig-Datei  File.cfg  um
  367.   den Dateinamen auf 8.3 zu kürzen. Es hat ein Eintrag in der File.cfg
  368.   der Art :
  369.  
  370.    ZModem (PC-Cut)  kürzt vorher auf 8.3
  371.    1
  372.    BBS:Bin/TrXPR %n zmodem T?,OY,B16,AN,DN,SN s %l
  373.    BBS:Bin/TrXPR %n zmodem T?,OY,B16,AN,DN,KN,SN,RN,P%f r ram:
  374.  
  375.   zu erfolgen.
  376.  
  377.  
  378. NOREAD
  379.   Schaltet die Möglichkeit ab Textdatei bzw. Archive  zu  lesen,  wenn
  380.   der  User  einen  kleineren  Level hat als der Download-Level in der
  381.   aktuellen Area ist.
  382.  
  383.  
  384. PRIVDIR <String>
  385.   Das Hauptverzeichnis in dem  die  privaten  Verzeichnisse  der  User
  386.   liegen.  Das  Verzeichnis des Users wird vom angelegt falls es nicht
  387.   existiert,  zudem  dürfen  die   Verzeichnisse   keine   Leerzeichen
  388.   enthalten,   da   TrXPR  auch  mit  Hochkommatas  nicht  DOS-Konform
  389.   arbeitet.
  390.  
  391.  
  392. PRIVACC <n>
  393.   Level der User um einen eigenen privaten Filebereich zu erhalten.
  394.  
  395.  
  396. FREQCFG <String>
  397.   Konfigdatei um Magics bei FileRequests  zu  unterstützen.  Ich  habe
  398.   mich  an  den  Syntax  von  FFRS gehalten, so daß hier auch die FFRS
  399.   Konfigdatei angegeben werden kann. Ansonsten ist der folgende Aufbau
  400.   zu beachten:
  401.  
  402.  
  403.   MAGIC FILE magicname filename with path [password]
  404.  
  405.  
  406. FREQACC  <n>
  407.   Level der User um Zugriff auf den FileRequest  Befehl  zugreifen  zu
  408.   können.
  409.  
  410.  
  411. UPLOADDIR <String>
  412.   Pfad in die alle Uploads gelenkt werden. Files.bbs  wird  upgedated,
  413.   *.desc  wird  angelegt.  Bei  der Beschreibung wird noch ein Eintrag
  414.   'Upload: UserName' angefügt.
  415.  
  416.  
  417. UNAME
  418.   Schaltet den oben genannten Eintrag 'Upload: UserName' aus.
  419.  
  420.  
  421. UPTIME
  422.   Switch um dem TAFileTagger zu sagen, daß die Zeit für ein Upload dem
  423.   User  wieder  zurückgegeben wird (Default: OFF). Ist MAXTIME kleiner
  424.   als 255 hat diese Option natürlich keine Wirkung.
  425.  
  426.  
  427. CHECK
  428.   Toggle um den IndexScan beim Upload einzuschalten. Dafür ist  vorher
  429.   mit  TAFileIndex  ein  IndexFile  zu erstellen. Dieses IndexFile ist
  430.   nach jeder Änderung im Filebereich neu zu erstellen!
  431.  
  432.   Ist ein Upload innerhalb des TAFileTaggers gemacht worden,  so  wird
  433.   die  Umgebungsvariable  'TAUpload' gesetzt, die z.B. im LogOff.trans
  434.   abgefragt werden kann.
  435.  
  436.  
  437. SYSOPDIR
  438.   Angabe des Pfades zur SysopArea (Default: BBS:SysopFiles).
  439.  
  440.  
  441. SETUPDIR
  442.   Angabe des Pfades zu den UserSetups für AreaExclude
  443.   (Default: BBS:System/Setups).
  444.  
  445.  
  446. UPDATAFILE
  447.   Switch damit kein Datafile nach einem Upload erzeugt wird.
  448.  
  449.  
  450. NOTIFY
  451.   Switch um beim Upload eines Users eine Mail an den Sysop loszuschicken.
  452.   (Default: OFF)
  453.  
  454.  
  455. TAG <String>
  456.   Soll die Notify-Message nicht im Netmail-Folder landen muss hier der
  457.   FidoArea-Tag angegeben werden (z.B. WUIVENDRIET.NEWFILES).
  458.  
  459.  
  460. ADDR <n>
  461.   Hier ist die Adresse aus Message.cfg angeben. Nicht die  FidoAdresse
  462.   selbst, sondern die wievielte Adresse es ist. (Default : 1)
  463.  
  464.  
  465. GROUP
  466.   Toggle um die Gruppenstruktur einzuschalten.
  467.  
  468.  
  469.   Aufbau der Gruppenstruktur  (Kleine  Rechtfertigung  warum  ich  das
  470.   File.cfg   derart   benutze:   Ich   bin  einfach  zu  faul  mehrere
  471.   Configdateien als Sysop zuverwalten, ich übersehe schon  ein  Update
  472.   für meinen FileRequestServer):
  473.  
  474.  
  475.   Soll über der Areastruktur von TransAmiga noch eine  Gruppenstruktur
  476.   gesetzt  werden,  so  sind  folgende  Änderungen bzw. Ergänzungen im
  477.   File.cfg zu tätigen :
  478.  
  479.  
  480.   Die Gruppen werden mit Hilfe  der  AreaFlags  definiert,  d.h.  alle
  481.   Areas einer Gruppe haben das gleiche AreaFlag. Die Areas sollten der
  482.   einfachheithalber  in  den  einzelnen  Gruppen  linear   aufgelistet
  483.   werden.  Der  Gruppenname MUSS in der ersten Area der Gruppe stehen,
  484.   als Eintrag wird pad1 der normalen Struktur benutzt. In der gleichen
  485.   Zeile,  abgetrennt durch , kann eine Beschreibung zur Gruppe stehen,
  486.   die im Gruppenmenue mit ausgegeben wird. In  pad2  kann  ebenso  ein
  487.   Text stehen, dieser wird als Beschreibung für die Area benutzt.
  488.  
  489.   Beispiel :
  490.  
  491. ************************************************************************
  492.  
  493. Wuivend Riet Information                : Areaname
  494. FILES:WuivendRiet/                      : Pfad
  495. 0                                       : DownloadAccess
  496. 0                                       : UploadAccess
  497. 0                                       : AreaAccess
  498. 0                                       : AreaFlags, jetzt Gruppennummer
  499. Infos zur Mailbox # Wegweiser           : Titel und Kommentar zur Gruppe
  500. Wichtige Sachen fuer Neue User          : Kommentar zur Area
  501. Hilfe fuer DFUe-Anfaenger
  502. FILES:Greenhorn/
  503. 0
  504. 0
  505. 0
  506. 1
  507. DFUe-Programme # Tools und Texte
  508. Texte fuer den Einstieg
  509. DFUe Utilities
  510. FILES:Applications/
  511. 0
  512. 0
  513. 0
  514. 1
  515.                                         : Jetzt muss pad1 leer bleiben
  516. Packer, Terminal-Programme
  517. C't Listings
  518. FILES:ct/
  519. 5
  520. 10
  521. 0
  522. 2
  523. Service und Sourcen                     : Kommentar ist nicht notwendig
  524. Listings und Inhaltsverzeichnisse
  525. Official Media Agency
  526. FILES:OMA/
  527. 0
  528. 255
  529. 0
  530. 2
  531.  
  532.                                         : Areakommentar ebenso
  533.  
  534. ************************************************************************
  535.  
  536.   Um eine Gruppe nur einem bestimmten User-Level zugänglich zu machen,
  537.   ist  in  der  ersten Area dieser Gruppe der gewünschte Level im Feld
  538.   AreaAccess einzutragen, dadurch ist die komplette  Gruppe  für  User
  539.   mit geringerem Level gesperrt.
  540.  
  541.   Denkt daran, daß neue User bzw. Gäste die entsprechenden  Flags  für
  542.   die Gruppen erhalten.
  543.  
  544.  
  545. SPECIALACCESS <n>
  546.   Damit gebe ich Gästen die Möglichkeit in bestimmten Areas downloaden
  547.   zu  können  (Upload  ist als Gast nicht möglich). Diese Areas werden
  548.   mit einem Download-Access=0 gekennzeichnet.
  549.   Es sollte natürlich darauf geachtet werden,  daß  der  SPECIALACCESS
  550.   kleiner  ist,  als der eines eingetragenen Users. Nach Verlassen von
  551.   TAFileTagger wird der Userlevel wieder auf 0 gesetzt.
  552.  
  553.  
  554. GUEST <n>
  555.   Kompatibel  zu  meinem  TAGuest-Programm.  Level  mit  der  gleichen
  556.   Bedeutung wie FirstCaller.
  557.  
  558.  
  559.  
  560. Hilfsprogramme
  561. --------------
  562.  
  563. TAFileIndex
  564. ***********
  565. Erzeugt eine Indexdatei für den TAFileTagger.  Diese  Indexdatei  wird
  566. benötigt  wenn  vor dem Upload überprüft werden soll, ob der User alte
  567. Dateien hochladen möchte.
  568.  
  569. Aufruf:  TAFileIndex <TransAmiga Konfigdatei>
  570.                      (DEFAULT: bbs:configs/Transmiga.cfg)
  571.  
  572.  
  573. TaggerCfgWrite
  574. **************
  575. WB-Applikation zum Bearbeiten der Konfigurationsdatei zum TAFileTagger.
  576.  
  577. Aufruf:  TaggerCfgWrite <TAFileTagger Konfigdatei>
  578.                         (DEFAULT: bbs:configs/TAFileTagger.cfg)
  579.  
  580.  
  581. TaggerConCfg
  582. ************
  583. CLI-Applikation   zum   Bearbeiten   der    Konfigurationsdatei    zum
  584. TAFileTagger.  Damit  kann  Online  unter  TrShell  die  Konfiguration
  585. geändert werden.
  586.  
  587. Aufruf:  TaggerConCfg <TAFileTagger Konfigdatei>
  588.                       (DEFAULT: bbs:configs/TAFileTagger.cfg)
  589.  
  590.  
  591. FileCfg2Txt
  592. ***********
  593. Extrahiert _nur_ den Pfad aus File.cfg.
  594.  
  595. Aufruf:  FileCfg2Txt CfgDir/K,PreTxt/K,PostTxt/K
  596.  
  597.          CfgDir (DEFAULT: bbs:configs)
  598.  
  599.          PreTxt:   Text vor dem Pfad
  600.          PostTxt:  Text nach dem Pfad
  601.  
  602.          Beispiel:
  603.  
  604.          FileCfgTxt PreTxt DIRECTORY PostTxt " FREE"
  605.  
  606.  
  607. TAAreaExclude
  608. *************
  609. Onlineprogramm mit dem der User bestimmte Fileareas "abmelden" kann.
  610.  
  611. Aufruf:  TAAreaExclude Line/A/K/N,SetupDir/K
  612.  
  613.          Line:      BBSLine
  614.          SetupDir:  Verzeichnis in dem die Userdaten abgespeichert werden,
  615.                     dies muss natürlich mit den Daten für den TAFileTagger
  616.                     übereinstimmen.
  617.                     (DEFAULT: bbs:system/setups)
  618.  
  619.          Im Rexx-Verzeichnis liegt noch ein Script FExclude.trans mit der
  620.          gleichen Aufgabe.
  621.  
  622.  
  623. UpdateExcl
  624. **********
  625. Sysopprogramm um bei "Anderungen der FileAreas die Excludedateien  der
  626. User der neuen Situation anzupassen.
  627.  
  628. Aufruf:  UpdateExcl OldCfg/A,NewCfg/A,SetupDir/A,Verbose/S
  629.  
  630.          OldCfg:    Alte File.cfg
  631.          NewCfg:    Neue File.cfg
  632.          SetupDir:  Verzeichnis in dem die Userdaten abgespeichert werden.
  633.          Verbose:   Gibt Auskunft welche Usersetups geändert werden.
  634.  
  635.          Es kann immer nur eine Generation upgedatet werden!!!
  636.  
  637.  
  638.  
  639. Danksagungen
  640. ------------
  641.  
  642.   Gehen   an   Sami    Radwan    für    seinen    Oberon-Source    der
  643.   TransAmiga-Schnittstelle und an den AMOK-Club für seine unermüdliche
  644.   Arbeit in Bezug auf Modula-2 und Oberon mit dem Amiga.
  645.  
  646.  
  647.   Aber auch nicht zu vergessen  ist  Andreas  Przystaw,  der  mir  mit
  648.   seiner  Geduld  und  seinem  Wissen  in  der  Beta-Phase sehr weiter
  649.   geholfen hat.
  650.  
  651.  
  652.   Und ein grundsätzliches Danke Schön an die User meines BBS.
  653.  
  654.  
  655.  
  656. Gewährleistung
  657. --------------
  658.  
  659.   Ich übernehme für Schäden und andere Folgen, die durch Benutzung des
  660.   Programmes entstehen können, KEINE Garantie.
  661.  
  662.   Diese Software unterliegt der "Standard Amiga FD-Software  Copyright
  663.   Note"  Sie  ist  SHAREWARE  wie  definiert  in  Absatz  4s. Für mehr
  664.   Informationen lies bitte "AFD-COPYRIGHT" (Version 1 oder höher).
  665.  
  666.  
  667.  
  668.  
  669. Zukunft
  670. -------
  671.  
  672.  * Debuggen
  673.  * Weitere Vorschläge einbauen.
  674.  * In ferner Zukunft eine ARexx-Schnittstelle integrieren.
  675.  
  676.  
  677.  
  678.  
  679. Inhalt des Paketes
  680. ------------------
  681.  
  682.    bin/
  683.    TAFileTagger           - Hauptprogramm
  684.    TAFileIndex            - Utility um das IndexFile für den Upload-Scan
  685.                             zu erzeugen.
  686.    TaggerCfgWrite         - WB-Applikation um die Konfigdatei zu bearbeiten.
  687.    TaggerConCfg           - CLI-Applikation um die Konfigdatei zu bearbeiten,
  688.                             so dass Änderungen online mit der TrShell möglich
  689.                             sind.
  690.    TAAreaExclude          - Externes Tool mit dem der User Areas "abmelden"
  691.                             kann
  692.    UpdateExcl             - Sysop Tool um die Exclude-Setups der User an das
  693.                             neue File.cfg anzupassen.
  694.    FileCfg2Txt            - Nichts besonderes...
  695.    configs/
  696.    TAFileTagger.cfg       - Example Config-File
  697.    Tagger.lang            - Language File (dt.)
  698.    Tagger.english.lang
  699.    Tagger.Deutsch.lang
  700.    text/
  701.    TaggerMainHelp.ANSI    - Die einzelnen Helpfiles zu den Menus.
  702.    TaggerListHelp.ANSI
  703.    TaggerArcHelp.ANSI
  704.    TaggerAreaHelp.ANSI
  705.    TaggerPrivateHelp.ANSI
  706.    TaggerFreqHelp.ANSI
  707.    TaggerSysopHelp.ANSI
  708.    system/
  709.    PrivUser               - Beispieldatei zu PrivUser.
  710.    rexx/
  711.    TAFileTagger.trans     - ARexx-Script um TAFileTagger von TransAmiga
  712.                             aus aufzurufen.
  713.    PrivUser.logon         - ARexx-Script um beim Login die private Area
  714.                             zu erzeugen.
  715.    FExclude.trans         - ARexx-Script, arbeitet wie TAAreaExclude
  716.    Download.tagger.0      - TAFileTagger-MagicRexxScript ala Download.trans.
  717.    Upload.tagger.0        - TAFileTagger-MagicRexxScript ala Upload.trans.
  718.    examples/
  719.    Logon.trans            - Beispiel-Script
  720.    LogOff.trans           - Beispiel-Script
  721.    Main.rx                - Example Config-File
  722.    UpdateTAIndex          - Example Script zum Updaten des IndexFiles
  723.    docs/
  724.    TAFileTagger.doc       - Englische Dokumentation.
  725.    TAFileTagger.dok       - Deutsche Dokumentation.
  726.    TAFileTagger_E.dvi     - Dokumentation (en).
  727.    TAFileTagger_D.dvi     - Dokumentation (de).
  728.    RegForm_E.txt          - Plain-ASCII-File zur Registrierung (en).
  729.    RegForm_D.txt          - Plain-ASCII-File zur Registrierung (de).
  730.    TAScrollerDoor.lha     - Der Sohn von TAFileTagger.
  731.  
  732.    Das Paket darf nicht verändert werden !!
  733.  
  734.  
  735.  
  736. Registrierung
  737. -------------
  738.  
  739.   Einen Unterschied zwischen registierter und  unregistrierte  Version
  740.   gibt  es  nun  doch,  dabei  treten  folgende  Erscheinungen bei der
  741.   Benutzung auf : Als NodeLocation wird
  742.  
  743.       '<UserName> is using TAFileTagger[UNREGISTERED]'
  744.  
  745.   gesetzt, als Prompt erscheint
  746.  
  747.       'REGISTERED TO [UNREGISTERED]',
  748.  
  749.   beim Beenden erscheint ein kleiner Requester und  der  User  hat  15
  750.   Sekunden zu warten.
  751.  
  752.   Ich würde mich selbstverständlich freuen, wenn die  User  den  Sysop
  753.   überzeugen  dieses  Programm  in der registrierten Form zu benutzen.
  754.   Die Registrierungsgebühr beträgt DM 25,-.
  755.  
  756.  
  757.   Diese Gebühr beinhaltet registrierte Versionen von :
  758.  
  759.              TAFileTagger
  760.              TAFileScroller  -   ANSI-FileScroller, es fehlt bei diesem
  761.                                  Programm nur die Option GROUP und läuft
  762.                                  somit als Ersatz für FileList.
  763.  
  764.          Updates
  765.          Hotline
  766.  
  767.  
  768.  
  769.    Bezahlung der Registrierungsgebühr :
  770.  
  771.  
  772.        Überweisung :
  773.          Jürgen A.Lamers
  774.          Postgiroamt Köln
  775.          KtoNr. : 4102 31-507
  776.          BLZ : 370 100 50
  777.  
  778.        EuroCheck in DM (bitte nur in DM) ausstellen auf :
  779.        Jürgen A.Lamers
  780.        Altstr. 112
  781.        D-52066 Aachen
  782.        GERMANY
  783.  
  784.  
  785.  
  786.  
  787. Adresse
  788. -------
  789.  
  790.     OMA-Software
  791.     Jürgen A.Lamers
  792.     Altstr. 112
  793.     D-52066 Aachen
  794.     Tel.: +49-(0)241-571489
  795.     Fax : +49-(0)241-573145
  796.     Box : +49-(0)241-573145
  797.  
  798.  
  799.  
  800.     Fido       Juergen A.Lamers            2:2452/121.0
  801.     E-Mail     jaloma@wuivendriet.fido.de  242:3000/3.0
  802.  
  803.  
  804.  
  805. Programmierhinweise
  806. -------------------
  807.  
  808.   Es werden vom TAFileTagger folgende Dateien zwischenzeitlich erzeugt:
  809.  
  810.  
  811.   <username>.tagger   Die markierte Dateien, getrennt durch ein
  812.                       Leerzeichen. (In T:)
  813.   UserUploads.dat<n>  Daten des letzten Uploads. (In BBS:System)
  814.  
  815.  
  816.  
  817.   Und folgende Umgebungsvariablen:
  818.  
  819.  
  820.   <username>.bytes.<line>  Anzahl der markierten Bytes.
  821.   <username>.files.<line>  Anzahl der markierten Files.
  822.   <username>.sort.<line>   Benutzte Sortieroption.
  823.   <username>.drift.<line>  Benutzte Sortierrichtung.
  824.   TAUpload                 Zeigt an ob ein Upload erfolgt ist.
  825.  
  826.  
  827.   Ich habe die Verzeichnisse T: und ENV: auf die Festplatte  verbannt,
  828.   somit  stehen  die  markierten  Dateien  den  Usern  auch nach einem
  829.   Systemabsturz zur Verfügung, dafür lasse ich nur  nach  einer  Woche
  830.   ein TrimDir über beide Verzeichnisse laufen.
  831.  
  832.   Zum Indexfile ist folgendes zu sagen:
  833.  
  834.   FileName      Länge: 32 Zeichen [0..32]
  835.   FileAreaPath  Länge: 80 Zeichen [0..80]  Damit ich offline zugreifen kann.
  836.  
  837.  
  838.  
  839.  
  840. Known Bugs
  841. ----------
  842.  
  843.  *  LocalDisplay NIEMALS während der Benutzung von  umschalten.
  844.  *  Ein Chat während des TAFileTaggers ist möglich. Nach Beendigung ist
  845.     der User wieder im Hauptmenu und der TAFileTagger bleibt anschliessend
  846.     im Speicher.
  847.  *  Es gibt Probleme mit AsXpr.
  848.  *  Bei Read-File kann es vorkommen, daß hier auch Binaries angezeigt werden!
  849.  *  Im Grunde kein Bug, aber die Optionen SPECIALACCESS und GUEST werden
  850.     wahrscheinlich bei einem nächsten Release herausfliegen
  851.